From b673490a1b492308462b97569941c3834a06214f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 28 Oct 2014 10:48:49 -0400 Subject: [PATCH] Document Wayland opacity handling --- gdk/gdkwindow.c | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c index 60401a3835..a4e2bbb565 100644 --- a/gdk/gdkwindow.c +++ b/gdk/gdkwindow.c @@ -10531,7 +10531,12 @@ gdk_window_configure_finished (GdkWindow *window) * * For toplevel windows this depends on support from the windowing system * that may not always be there. For instance, On X11, this works only on - * X screens with a compositing manager running. + * X screens with a compositing manager running. On Wayland, there is no + * per-window opacity value that the compositor would apply. Instead, use + * `gdk_window_set_opaque_region (window, NULL)` to tell the compositor + * that the entire window is (potentially) non-opaque, and draw your content + * with alpha, or use gtk_widget_set_opacity() to set an overall opacity + * for your widgets. * * For child windows this function only works for non-native windows. * -- 2.30.2